Skip to content

v3.2: Support nested multipart with nested Encoding Objects #4747

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Jul 20, 2025

Conversation

handrews
Copy link
Member

In PR #4589, both of the most in-depth reviewers (@jeremyfiel and @ralfhandl) requested support for nested multipart/mixed with real-world use cases.

This adds the Media Type Object's three encoding fields to the Encoding Object to support nested multipart documents. It only requires one level of nesting, but allows implementations to support more, which seemed like a reasonable compromise as a fully-recursive system is quite complex.

This PR relies on PR #4743 to address the complexities of correlating Encoding Objects and Schema Objects, and determining the instance type in order to properly default contentType.

  • schema changes are included in this pull request
  • schema changes are needed for this pull request but not done yet
  • no schema changes are needed for this pull request

This adds the Media Type Object's encoding field to the Encoding
Object to support nested multipart documents.  It only requires
one level of nesting, but allows implementations to support more.
@handrews handrews added this to the v3.2.0 milestone Jun 21, 2025
@handrews handrews requested review from a team as code owners June 21, 2025 02:08
@handrews handrews added the media and encoding Issues regarding media type support and how to encode data (outside of query/path params) label Jun 21, 2025
@karenetheridge
Copy link
Member

Oh come on, we can do full recursion ;)

ralfhandl
ralfhandl previously approved these changes Jul 19, 2025
@ralfhandl ralfhandl requested a review from a team July 19, 2025 15:03
@handrews
Copy link
Member Author

@ralfhandl with apologies, you'll have to hit the review button again- I stripped out the line requiring documentation of nesting level limitations as documentation requirements proved controversial on another PR. Which I still find baffling but at this point I just want the changes in and don't want to argue about the documentation stuff.

@ralfhandl ralfhandl merged commit 22e5582 into OAI:v3.2-dev Jul 20, 2025
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
media and encoding Issues regarding media type support and how to encode data (outside of query/path params)
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants